home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / os2 / zipctl / readme.doc < prev    next >
Encoding:
Text File  |  1994-01-23  |  18.1 KB  |  397 lines
  1.  RPF Zip Control(TM) Copyright 1993, 1994 RPF Software ALL RIGHTS RESERVED
  2.  
  3.  Abstract
  4.  --------
  5.  Zip Control is an OS/2 program which uses a PM interface to access
  6.  the freeware programs UNZIP.EXE and ZIP.EXE.  UnZip and Zip are 
  7.  command line programs which are compatible with versions 1 & 2 of the 
  8.  DOS PkZIP program.  UnZip and Zip are available as freeware on many 
  9.  BBS's which have OS/2 libraries, on the IBM NSC BBS, and on 
  10.  CompuServe (OS2USER forum, Library 4 for UNZ501.EXE, Library 1 for
  11.  ZIP201.ZIP).  Zip and UnZip are freeware products of Info-ZIP.
  12.  Zip Control is a shareware product of RPF Software.  Info-ZIP and
  13.  RPF Software are independent organizations.
  14.  
  15.  Zip Control is available on CompuServe (OS2BVEND Forum, Library 1, &
  16.  OS2USER Forum, Library 4), Pete Norloff's OS/2 Shareware BBS 
  17.  (703.385.4325), Fernwood BBS (203.483.0348), Pandora's Box
  18.  (619.291.9716), Prodigy OS/2 Club, America On Line, and other BBS's
  19.  which carry OS/2 software.  Primary support is via email and in
  20.  CompuServe's OS2BVEND Forum, Section One (OS/2 Shareware).
  21.  
  22.  Zip Control is copyrighted shareware, it is NOT PUBLIC DOMAIN, it is
  23.  NOT FREE.  You are encouraged to use it for a reasonable evaluation
  24.  period (21 days) to see if it is software which is helpful to you
  25.  and which you wish to continue using.  If you do decide to continue
  26.  using Zip Control, you MUST register your copy of Zip Control by
  27.  filling out the form in ORDER.DOC and sending it along with the
  28.  registration fee to RPF Software.
  29.  
  30.  Alternatively, and perhaps easier, you may register using the
  31.  CompuServe online registration service.  The registration fee will
  32.  be added to your CompuServe bill.  To use this method, GO SWREG.
  33.  The registration number is 1373 or search for "RPF Zip Control."
  34.  
  35.  The registration fee is currently US$22.00.
  36.  
  37.  Features of this Version
  38.  ------------------------
  39.  **Do not use this version of Zip Control with password encrypted
  40.    zip files.  See note below.
  41.  
  42.  - PM interface for the freeware UNZIP.EXE and ZIP.EXE programs.
  43.  
  44.  - "Open" provides standard OS/2 file open dialog box for the user 
  45.    to select which ZIP file to open and then displays the contents
  46.    of the ZIP file in a list box.
  47.  
  48.    "AutoOpen", when checked, will cause the file open dialog box to
  49.    appear at the beginning of each Zip Control session.  The AutoOpen
  50.    setting is remembered from session to session.
  51.  
  52.  - "Settings" - This notebook of settings includes settings for 
  53.    Options, Paths, and Programs.
  54.  
  55.    + "Options" saves user-specified default options:
  56.  
  57.      * "Respect" the stored path(s) in the ZIP file (or not)
  58.    
  59.        "Respect" (the default and recommended), when checked, will 
  60.        unzip the files in the .ZIP file to the target directory, 
  61.        create (if necessary) the relative paths (directories) as 
  62.        subdirectories to the target directory, and properly place 
  63.        the unzipped files in the correct subdirectories.
  64.  
  65.        When "Respect" is NOT checked, the files in the .ZIP file 
  66.        will be placed in the target directory . . . even if the
  67.        intended file paths had been stored in the .ZIP file.
  68.    
  69.      * "Update" existing files and create new ones as needed
  70.      
  71.        "Update" will, during the unzip process, replace existing 
  72.        files of the same name in the target directory IF and ONLY IF
  73.        the files in the .ZIP file have a later creation date than
  74.        the same-named files in the target directory.
  75.  
  76.        "Update" will also, during the unzip process, unzip any files 
  77.        in the .ZIP file which are not in the target directory.
  78.  
  79.      * "Freshen" existing files, but do not create new files
  80.  
  81.        "Freshen" will perform as "Update" (above) does but WILL NOT unzip 
  82.        any files in the .ZIP file which are not in the target directory.
  83.  
  84.        "Freshen" is not compatible with the "Never overwrite" option, 
  85.        since "never overwriting" existing files and not unzipping files
  86.        which do not exist in the target directory leaves nothing for 
  87.        UNZIP.EXE to do.
  88.  
  89.      * "Update" and "Freshen" are mutually exclusive selections.
  90.  
  91.      * With neither "Update" nor "Freshen" selected (the default and 
  92.        recommended), the files ("Selected" or "All") in the .ZIP 
  93.        file will be unzipped to the target directory, REPLACING any
  94.        existing files of the same name, regardless of file creation 
  95.        date, and also unzipping files which do not currently exist in
  96.        the target directory . . . subject to the "Never overwrite" 
  97.        option.
  98.  
  99.      * "Never overwrite" existing files
  100.  
  101.        "Never overwrite" will prevent UNZIP.EXE from unzipping files 
  102.        from the .ZIP file which already exist in the target directory.
  103.  
  104.    + "Paths" saves user-specified default paths
  105.    
  106.      * Directory where ZIP files usually are.  Set this path (drive
  107.        and directory) to where you normally download ZIP files.
  108.  
  109.      * Directory where ZIP files are usually unzipped into.  Set this
  110.        path (drive and directory) to where you usually want ZIP files
  111.        unzipped.
  112.  
  113.      * The option to, by default, unzip files into the same directory
  114.        in which each ZIP file is located (rather than using the 
  115.        default output directory).
  116.        
  117.    + "Programs" saves user-specified default programs
  118.    
  119.      * The name, and optionally path, of the ZIP program
  120.  
  121.      * The name, and optionally path, of the UNZIP program
  122.  
  123.      * The name(s) and optionally, path(s) of the program(s) with 
  124.        which you wish to view files stored within the ZIP file.
  125.  
  126.        A default viewer can be defined.  Additionally, specific 
  127.        viewers can be associated with files of user defined file
  128.        extensions.  For example, the viewers E.EXE, EPM.EXE,
  129.        VIEW.EXE, LIST.EXE, and GALLERIA.EXE could be associated with
  130.        <default>, .DOC, .INF, .TXT, and .BMP files respectively.
  131.        ICONEDIT.EXE could be associated with both .ICO and .PTR files.
  132.  
  133.        For ZIP files with embedded ZIP files, you could associate 
  134.        ZIPCNTRL.EXE with the .ZIP files, so that you could "view"
  135.        the contents of embedded ZIP files . . . and so on to 
  136.        multiple depths of viewing.
  137.  
  138.        With due caution, you could associate CMD.EXE /C or START /WIN
  139.        with .EXE files to run the .EXE programs.  Also, 
  140.        START /WIN xxxx.exe (e.g., WinWord.exe for WinWord .doc files)
  141.        will start a DOS or Windows application in a seamless window,
  142.        rather than running, in Windows' case, full screen Win-OS2.
  143.  
  144.  - "UnZip" acts on highlighted files in the list box (from the ZIP
  145.    file) or ALL files.  You first have an opportunity to override 
  146.    the defaults listed in "Settings - Options & Paths" above and 
  147.    to override the target directory.  The target directory will 
  148.    be created if it does not exist.  A progress indicator is 
  149.    provided.
  150.  
  151.    Also, the output path may be temporarily "for this session only"
  152.    changed to either the default output path, the last output path,
  153.    or the path where the .ZIP file is located.
  154.  
  155.  - "View" passes ALL highlighted files in the list box to the
  156.    VIEW program(s) (E.EXE, LIST.EXE, etc.) defined in the 
  157.    Programs page of the Settings notebook.  This means several
  158.    files can be viewed at the same time.
  159.  
  160.    If the "SmartView" box is checked, each file viewed will be
  161.    viewed using the defined viewer for that type of file.  If the
  162.    box is not checked, the <default> viewer will be used.  The
  163.    default viewer may be helpful for viewing files which, as an 
  164.    example, have an .INF file extension, but are actually plain 
  165.    text files.
  166.  
  167.  - "Print" presents a listing of the files which have been 
  168.    highlighted.  These files can be left selected (for printing)
  169.    or not (will not be printed).  Then the files will be printed
  170.    to the printer which is selected from one of the installed 
  171.    printers.
  172.  
  173.    Simple LaserJet 2-up printing is an option.
  174.  
  175.  - "Comments" displays the embedded ZIP file comments, if present.
  176.  
  177.    If the "AutoComments" box is checked, comments (if any) stored 
  178.    in the ZIP file will automatically be displayed.
  179.  
  180.  - "Product Information" shows contact information for RPF Software
  181.    and provides a method to enter user name and registration 
  182.    number (received after registration via ORDER.DOC or GO SWREG).
  183.  
  184.  - "Search" is used to build a list of all .ZIP files on one or 
  185.    more disk drives.  The list of files is sorted by name+date+
  186.    path, path+name+date, or date+name+path.  This sort order can 
  187.    be changed at any time, without necessitating a re-search of
  188.    the disk drives.  If "Ascending" is checked, then the sort
  189.    will be in ascending order, otherwise it will be in descending
  190.    order.
  191.  
  192.    Individual files in the list may be selected for either 
  193.    deletion (perhaps duplicates) or opening (unzipping).  
  194.  
  195.    All the other Zip Control capabilities are available for ZIP
  196.    files opened from the Search window.
  197.  
  198.  - "New" - Zip Control opens in "New" mode.  The file name is
  199.    "<Untitled>".  Choose "Add" to add files to the, as yet,
  200.    unnamed zip file.  If you choose "New" without having saved
  201.    a previous Untitled zip file, you will be given the opportunity
  202.    to save it.
  203.  
  204.  - "Add" - An entire directory or selected files may be added to 
  205.    the "Selected" list.  As you add each selection to the list,
  206.    the "Store path", "Subdirectories", "Freshen", "Update", "ZIP
  207.    date", and compression speed choices will be applied to the
  208.    selected files and directories.  Additions may be made to a 
  209.    new "<Untitled>" .ZIP file or to an existing named .ZIP file.
  210.  
  211.    See above for "Freshen" and "Update".
  212.  
  213.    "Zip all subdirectories too" zips all files in the selected 
  214.    directory plus all the files in its subdirectories.  In most
  215.    cases you should also select "Store path relative . . ." so
  216.    that Zip can resolve zipping two files with the same file
  217.    name.  If you are certain that no two file names in the
  218.    highlighted directory and its subdirectories have the same
  219.    name, "Store path relative . . ." is optional.
  220.  
  221.    "Store path relative . . ." will store the proper path names
  222.    in the zip file, relative to the highlighted directory.  If
  223.    you have selected several files from the "File" list, those 
  224.    files will be zipped, stored with the beginning path being the
  225.    highlighted path in the "Directory" list.  If you have selected
  226.    (highlighted) a directory with the "Select Entire Directory"
  227.    button, the entire directory will be zipped, stored with the
  228.    beginning path being the highlighted path in the "Directory"
  229.    list.
  230.  
  231.    "ZIP date = latest file date" - The file date of the .ZIP file
  232.    will be changed to match the date of the newest file in the
  233.    .ZIP file.
  234.  
  235.    Compression can be adjusted, by dragging the slider button, 
  236.    from 1 (the fastest compression mode--larger .zip files) to
  237.    9 (the slowest compression mode--smallest .zip files).  The
  238.    default is 6.
  239.  
  240.    Once files have been added to the "Selected" list, they may be
  241.    highlighted.  Files selected (highlighted) when the "Delete"
  242.    button is pressed will be removed from the "Selected" list.
  243.  
  244.    Files are not actually zipped and added to the .ZIP file until
  245.    the "OK" button is pressed.
  246.  
  247.    "Comments" - This selection allows you to add comments to the
  248.    .ZIP file.  After this selection is made, any current comments
  249.    for the file will be displayed.  These may be changed or deleted
  250.    or additional comments added.
  251.  
  252.    "Cancel" - All proposed additions to the .ZIP file and comment
  253.    changes are cancelled.
  254.  
  255.  - "Delete" - Use this selection to delete selected files from an
  256.    existing .ZIP file.  A confirmation is required.
  257.  
  258.  - "Save As" - An existing .ZIP file, either "<Untitled>" or named,
  259.    will be saved to a name you select.  Save As will not replace or
  260.    rename an existing file, but will create a copy of the existing
  261.    file with the new file name.  As an example, if the current file
  262.    is "Backup.zip", Save As may create a new file "110393.zip" (a
  263.    copy of Backup.zip), but leave Backup.zip as it was.  This will
  264.    allow you to safely delete and add files to the new .ZIP file
  265.    without harming the original .ZIP file.  The Save As has to be 
  266.    done prior to the deletion and addition since those choices
  267.    perform immediate deletion and addition to the current .zip file.
  268.  
  269.  Known Problems
  270.  --------------
  271.  - Password protected zip files are not currently supported.  
  272.    Attempts to unzip such files will stall Zip Control, and
  273.    you will have to use the window task list to close Zip
  274.    Control.  You may then also have to do Ctl-Esc and then
  275.    press Enter (when prompted) to complete the closure of
  276.    Zip Control.
  277.  
  278.    The cause for this is our current inability to intercept
  279.    UNZIP.EXE's request for the password.
  280.  
  281.  Zip Control Error Messages
  282.  --------------------------
  283.  - Most users find Zip Control easy to use and register the software
  284.    without reporting any problems.  However, other users may have a
  285.    different operating environment or may use Zip Control with .zip
  286.    files where ZIP.EXE or UNZIP.EXE send Zip Control error messages
  287.    which we have not seen before.  In those cases, the ZC users will
  288.    see a general error message from ZC which displays the error number
  289.    and additional information and is asked to report the circumstances
  290.    to RPF Software.
  291.  
  292.    At that point RPF Software duplicates the problem and, if the
  293.    problem is caused by Zip Control, makes the necessary software
  294.    repairs to properly handle the problem.  A new version of ZC is
  295.    then made available.
  296.  
  297.  - The error message may offer to display the specific error message
  298.    as reported by zip.exe or unzip.exe.  This may alert you to a
  299.    problem with the .zip file with which you are working.
  300.  
  301.  Futures
  302.  -------
  303.  Use of threads.
  304.  Help buttons/system.
  305.  Right mouse button support.
  306.  More use of drag-and-drop within Zip Control.
  307.  PkUnZip, PkZIP, LHArc support.
  308.  Performance improvements.
  309.  User suggestions will be incorporated, as appropriate.
  310.  
  311.  Files Included
  312.  --------------
  313.  ReadMe.doc
  314.  History.doc
  315.  Order.doc
  316.  Warranty.doc
  317.  SysOp.doc
  318.  ZipCntrl.exe
  319.  
  320.  Installation Instructions
  321.  -------------------------
  322.  Unzip the delivery files to a new directory, such as \ZipCntrl.
  323.  Create a workplace shell object which references ZipCntrl.exe
  324.  (with full path) as the program name and enter the same path as
  325.  the working directory.
  326.  
  327.  Run Zip Control by either double clicking on the Zip Control
  328.  object on the desktop OR by dragging one or more .ZIP files
  329.  to the Zip Control desktop object (using the right mouse
  330.  button).  If multiple .ZIP files are dragged to the Zip Control 
  331.  object, multiple versions of Zip Control will be started, each 
  332.  displayed on top of the other.  You can then use these to perform 
  333.  simultaneous unzips or to investigate the various .ZIP files, 
  334.  comparing dates of zipped files, and viewing zipped files.
  335.  
  336.  If an "association" is established for *.zip files (to the Zip
  337.  Control desktop object), Zip Control can be started by double
  338.  clicking .zip files displayed using the Drives object.  To
  339.  establish the association, open the Settings window for the
  340.  Zip Control desktop object and select the "Association" page
  341.  (tab).  In the lower section of the page, enter "*.zip" 
  342.  (without the quotes) in the "New Name" field.  Then select "Add."
  343.  
  344.  If there had been a previous association established with another
  345.  program, that association should be removed from either the other
  346.  program's desktop object OR from the other program's .EXE file (via
  347.  the Drives object), before establishing a new association with Zip
  348.  Control.  To determine whether a previous association is in effect
  349.  and to what program or object, do a right mouse button click on a
  350.  Drives listing of a .zip file, then select the arrow to the right
  351.  of "Open."  Any current associations will be listed below the word
  352.  "Settings."
  353.  
  354.  Use the "Paths" page of the "Settings" notebook in Zip Control 
  355.  to define the path where .ZIP files will usually be found, 
  356.  such as C:\DOWNLOAD.  Also, define a default output directory, 
  357.  such as C:\SCRATCH and a work location directory.  If you do not
  358.  define a Work Location, the default work location directory will 
  359.  be set to the directory in which zipcntrl.exe resides.  A change
  360.  in Work Location does not take effect until restarting Zip Control.
  361.  
  362.  Note:  A subdirectory, ~ZIPWork, of the work location directory 
  363.  is used for Zip Control temporary files created when using "View",  
  364.  "Print", "New", "Add", and "Delete".  The temporary files should be 
  365.  automatically cleaned up.  However, if they are not automatically 
  366.  deleted, you may delete them at any time.  The temporary files 
  367.  should all be located in the ~ZIPWork subdirectory.
  368.  
  369.  You may wish to create a "shadow" of your default output 
  370.  directory (e.g., C:\SCRATCH) on your desktop and have it open
  371.  when using Zip Control.  As you unzip each .ZIP file, the 
  372.  unzipped files will appear in the output directory on your
  373.  desktop where you can either test run the unzipped application
  374.  or otherwise evaluate the files.  Then, when you no longer
  375.  want those unzipped files, you can graphically "select" all
  376.  (or some) of the unzipped files and delete them.
  377.  
  378.  Advanced users may wish to create a Zip Control work area (folder)
  379.  on the desktop, containing open shadows of Zip Control, the 
  380.  default .ZIP directory, and the default output directory.  Rather
  381.  than closing Zip Control, close the Zip Control work area while
  382.  the application is still running.  Thereafter, when you open
  383.  the Zip Control work area, Zip Control will start automatically,
  384.  and the two working directory folders will reopen where you last 
  385.  left them.
  386.  
  387.  ------------------ Contact Information for Support -------------------
  388.  Attn:  Richard Fortson        FAX:  404.250.0282
  389.  RPF Software                  CompuServe:  71660,535
  390.  P.O. Box 420457               INTERNET:71660.535@compuserve.com
  391.  Atlanta, GA  30342            (use above for Prodigy, AOL, MCIMAIL, Internet)
  392.  
  393.  --------------------------
  394.  "Support OS/2 development"
  395.  --------------------------
  396.  
  397.